home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / editors / fixtx611.zip / BRUCE.DOC < prev    next >
Text File  |  1996-11-30  |  14KB  |  268 lines
  1. BRUCE.DOC                            1                         Revised: 11-30-96
  2.  
  3. --------------------------------------------------------------------------------
  4.                                   Introduction
  5.  
  6. This documentation provides some overview information on a number of  utilities.
  7. All  programs  described  herein  were  written  by  Bruce  Guthrie.   Most  are
  8. distributed with a Wayne Software copyright.  Others were written for  the  U.S.
  9. Department of Commerce.
  10.  
  11. All programs are free for use provided relevant documentation is kept  with  the
  12. programs, no changes are made to the programs or documentation, and they are not
  13. bundled with commercial programs or charged for separately.
  14.  
  15. CHANGE,  CONVERT,  FILUPDAT,   READ,   and   READY   are   excluded   from   the
  16. commercial-packaging  restriction.   These  programs  are  owned  by  the   U.S.
  17. Department of Commerce and may be re-distributed without restriction.
  18.  
  19. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL, EUMAIL,
  20. FILL, FIXTEXT,  FORTUNE,  HTMSTRIP,  MOZ,  PAGINATE,  READINIT,  or  TXTABLE  in
  21. commercial packages other than shareware/freeware collections  must  pay  a  $50
  22. registration fee to "Wayne Software" at the following address.  READMAKE-created
  23. files are also subject to this limitation.  I don't expect  to  make  any  money
  24. from  these  utilities  but  I  don't  want  others  to   sell   them   instead.
  25. Shareware-distribution groups that charge more than $7 for a diskette or $20 for
  26. a CD-ROM are, as far as I'm  concerned,  making  excessive  profits  from  these
  27. programs--they're actual costs are way below this--and probably  keeping  people
  28. from registering the other shareware on the disk; I do not want these  types  of
  29. places distributing my programs.
  30.  
  31. This collection of utilities were compiled using Microsoft's  Visual  BASIC  for
  32. DOS 1.0 compiler in  addition  to  Thomas  G.  Hanlin  III's  excellent  PBClone
  33. routines.  Both the compiler and the library are now officially  "dead",  as  is
  34. DOS apparently, so adding support for new data  formats  and  such  may  not  be
  35. possible.  Keep in mind that they are DOS-based routines so  forget  long  Win95
  36. file names and such.  I keep thinking that I should be doing Windows programming
  37. but it's hard to get psyched up for that when you think of Windows as a computer
  38. virus.
  39.  
  40. Documentation provided in appropriate ZIP files:
  41.  * routine.DOC: Each utility is separately described in a like-named *.DOC file.
  42.  * FILE_ID.DIZ: Standard "Description In Zip" file.
  43.  * BRUCE.DOC: This file serves to summarize all of the various utilities.
  44.  * BRUCEINI.DOC: Most of the routines have defaults that can  altered  by  using
  45.      initialization files (inifiles).   These  are  referenced  in  the  regular
  46.      documentation and further described here.
  47.  * BRUCEHEX.DOC: Many of the routines allow you to enter  parameters  as  either
  48.      hexadecimal  or  decimal  strings.   This  is  referenced  in  the  regular
  49.      documentation and further described here.
  50.  * HISTORY.ymm: List of  recent  modifications  to  all  programs.   The   "ymm"
  51.      indicates the release date in year/month format.  "601" means  1996,  first
  52.      month (Jan 1996).
  53.  
  54. All program documentation was created using a text editor (PE2).   The  PAGINATE
  55. command (see below) was used to justify the text and create titles, page breaks,
  56. and (where provided) indexes.
  57.  
  58.  
  59. BRUCE.DOC                            2                         Revised: 11-30-96
  60.  
  61. --------------------------------------------------------------------------------
  62.                               Contact information
  63.  
  64. For the following routines:  AV,  BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  65. EUMAIL,   FILL,   FIXTEXT,   FORTUNE,   HTMSTRIP,   MOZ,   PAGINATE,   READINIT,
  66. READMAKE-created files, and TXTABLE:
  67.  
  68.                 Bruce Guthrie
  69.                 Wayne Software
  70.                 113 Sheffield St.
  71.                 Silver Spring, MD 20910
  72.  
  73.                 fax: (301) 588-8986
  74.                 e-mail: bguthrie@nmaa.org
  75.                 http://hjs.geol.uib.no/guthrie/
  76.  
  77. For the following routines:  CHANGE, CONVERT, FILUPDAT, READ, and READY:
  78.  
  79.                 Bruce Guthrie
  80.                 Room H-4885
  81.                 U.S. Dept of Commerce/ESA/STAT-USA
  82.                 Washington, DC 20230
  83.  
  84.                 fax: (202) 482-2164
  85.                 voice: (202) 482-3234
  86.                 e-mail: bguthrie@doc.gov
  87.  
  88. Please provide an Internet e-mail address on all correspondence.
  89.  
  90. Since these programs are typically "freeware"  (with  the  exception  of  people
  91. trying to make money from them instead of me), they generate maybe $100/year  in
  92. revenue for me.  As such, my ability to afford  wonderful  customer  support  is
  93. somewhat restricted.   Please  do  not  leave  messages  saying  "Call  me  long
  94. distance".  Also, please be specific  about  what  problems  you  encounter  and
  95. include command-line inputs as well as any control  or  INI  files  that  you're
  96. using.
  97.  
  98. Beta  testers  and  suggestions  are  always   appreciated.    Contact   me   at
  99. bguthrie@nmaa.org  Note that all beta releases are done via e-mail  so  if  your
  100. gateway can't handle some pretty big mail attachments,  you  definitely  do  NOT
  101. want to be a beta tester for me!  Modifications that are not of  mainstream  use
  102. can be contracted for.
  103.  
  104. WIN/NT AND WIN95 USERS:  All of these programs are DOS applications.  This means
  105. that they expect 8.3 filenames, short paths, etc.  If  you  use  long  paths  or
  106. illegal characters in your file names or whatever, these programs may  not  work
  107. for you.  This is not a "bug" in the software.  That's just  the  way  DOS  apps
  108. are.
  109.  
  110. STANDARD LEGAL DISCLAIMER:  Wayne Software disclaims all warranties as  to  this
  111. software, whether express or implied, including without limitation  any  implied
  112. warranties of merchantability, fitness for a particular purpose,  functionality,
  113. data integrity or protection.
  114.  
  115.  
  116. BRUCE.DOC                            3                         Revised: 11-30-96
  117.  
  118. --------------------------------------------------------------------------------
  119.           Finding the programs--Current version is 611 (1996 November)
  120.  
  121. The utilities are uploaded with a ZIP name that includes the year and  month  of
  122. the release in a "ymm" format (mm-number month where 01=January,  and  199y  for
  123. year).  The files are  posted  directly  by  the  author  to  two  places.   The
  124. following Web site, provided by Hans Schrader, has the current versions of *all*
  125. programs:
  126.  
  127.                 http://hjs.geol.uib.no/guthrie/
  128.  
  129. Major revisions are directly posted by the author to the following:
  130. * Simtel (Coast-To-Coast): ftp.coast.net (http://www.coast.net/Simtel)
  131. * Simtel (Keith Petersen): ftp.simtel.net (http://www.simtel.net/simtel.net)
  132. * ZDI Software Library:  No idea where that is!
  133.  
  134.                          Simtel locations and versions
  135.  
  136. http://www.coast.net/SimTel/msdos/      ftp://ftp.simtel.net/simtelnet/msdos/
  137.   ..arcutil/                            ..arcutils/
  138. av607.zip       Archive View: Free ZIP etc directory viewer
  139.   ..batutil/                            ..batchutl/
  140. dates611.zip    Warns you in advance of birthdays etc
  141. fortn608.zip    Fine-tunes DOS FOR command w/options
  142.   ..dirutil/                            ..dirutl/
  143. cops611.zip     Copies files modified since given date
  144. dirco611.zip    Updates files based on source directory
  145. dirto610.zip    Directory lister and totaller
  146. filup610.zip    Copy updated files based on a control list
  147.   ..diskutil/                           ..diskutil/
  148. fill610.zip     Stuffs as many files as possible on disk
  149.   ..internet/                           ..html/
  150. htmst611.zip    Reprocesses HTML pages for humans to read
  151.   ..offline/                            ..mailnews/
  152. eumal611.zip    Eudora utility for nicknames, boxes
  153.   ..spredsht/                           ..spredsht/
  154. convr611.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  155.   ..textutil/                           ..txtutl/
  156. bfind610.zip    Boolean FIND command (BFIND BEGIN & END)
  157. chang610.zip    Change strings in text/binary files
  158. fixtx611.zip    Translate text file characters en masse
  159. pagin611.zip    Paginates text (indexes, sorts, tables)
  160. read609.zip     Free viewer, also make any text self-viewing
  161. txtab611.zip    Generates text tables
  162.  
  163. If you're using a version of the programs that's more  than  a  year  old,  it's
  164. almost always the case that there's  a  newer  version.   Please  check  for  an
  165. update.  If you can receive binary attachments, contact me at  bguthrie@nmaa.org
  166. for free updates.  Alternatively, send $10 made out to "Wayne Software"  to  the
  167. Wayne Software address above and I'll send you everything on diskette.  (If  you
  168. need anything other than 3.5" high density, specify that too please.)
  169.  
  170. The versions of each program posted on SimTel are documented  below  along  with
  171. the directory information for  this  site.   The  *current*  versions  of  *all*
  172. programs are posted on the Web site in Norway.
  173.  
  174.  
  175. BRUCE.DOC                            4                         Revised: 11-30-96
  176.  
  177. --------------------------------------------------------------------------------
  178.                            Short program descriptions
  179.  
  180. AV.EXE: Archive directory viewer.  Presents list of files in archive (ZIP,  ARC,
  181.    etc) and lets you sort as desired.  Also allows resetting of  the  file  date
  182.    based on the archive's contents.
  183.  
  184. BFIND.EXE: Allows Boolean-type FIND requests.  For example, find any  line  with
  185.    one string AND another one, or any line with one  string  OR  another.   Also
  186.    allows wildcarded input file names.
  187.  
  188. CHANGE.EXE: Processes change commands in files.  Files can be of  any  size  and
  189.    type (e.g. binary or text) and are processed quickly.  Up  to  thirty  change
  190.    commands can be processed in a single pass.  Also provides ability to  remove
  191.    trailing spaces from text files.
  192.  
  193. CONVERT.EXE: Converts between  data  formats:    FROM   dBase,   ASCII-delimited
  194.    (typically commas between fields and quotes around strings), and fixed  field
  195.    TO Lotus WKS, ASCII-delimited, dBase, and fixed field.  Also provides ability
  196.    to add and drop fields, giving you the ability to crunch tables.
  197.  
  198. COPSINCE.EXE: Copies all files modified since a given date.  Primarily used  for
  199.    making sure you have a back-up of files and also to copy updated programs  to
  200.    another place.  Lets you define your own groupings of files if desired.
  201.  
  202. DATES.EXE: Program that warns you in advance when  an  event  like  a  birthday,
  203.    anniversary, or holiday is coming up.   The  idea  is  to  give  you  advance
  204.    warning so you can send a card or get out of town in time.
  205.  
  206. DIRCOMP.EXE: Similar in some ways to DOS's REPLACE command but adds  ability  to
  207.    delete extra files in the destination subdirectory, copy  hidden  and  system
  208.    files, and prepare a report showing inconsistencies.  Is frequently  used  by
  209.    network administrators to update workstation files.
  210.  
  211. DIRTOTAL.EXE: Prepares report showing files in subdirectory  or  drive.   Allows
  212.    restricting search based on date, size, attributes, etc.  Works on  networked
  213.    and CD-ROM drives.  Produces more formalized report than some  utilities  do.
  214.    Also allows you to look for duplicate file names.
  215.  
  216. EUMAIL.EXE: Eudora mail summarizer.  Dumps your Qualcomm Eudora mailbook as well
  217.    as summarizing the contents of all of your Eudora boxes and folders.
  218.  
  219. FILL.EXE: Program designed to move files off to  floppy  diskettes,  taking  the
  220.    biggest files first and skipping those that won't fit.  Also provides  option
  221.    of splitting large files, creating a status report, and other features.
  222.  
  223. FILUPDAT.EXE: Program which compares a selected list of files in a  source  path
  224.    against those in another path  and  copies  those  that  have  been  updated.
  225.    Similar to DOS' REPLACE command  but  works  from  a  stored  list  of  files
  226.    (controlled updates) and can handle any number of directories.
  227.  
  228.  
  229. BRUCE.DOC                            5                         Revised: 11-30-96
  230.  
  231. FIXTEXT.EXE: Program which applies a user-definable character-translation  table
  232.    to a text file.  Can allow you to convert graphics characters to  their  text
  233.    equivalents, lowercase letters to uppercase letter, etc.  Can also be used to
  234.    translate DOS text files to Mac or Unix text files and vice versa.  Can  also
  235.    expand tabs, remove leading  and  trailing  spaces,  remove  backspaces,  and
  236.    remove blank lines.
  237.  
  238. FORTUNE.EXE: A tuner-upper for the DOS FOR  command.   Generates  a  batch  file
  239.    which does all those wildcard things you wished FOR could do  (like  "FORTUNE
  240.    IN (*.BAS) DO RENAME %A %2*.*" to remove parts of file names).  Lets  you  do
  241.    all sorts of things including  distinguishing  file  name  roots  from  their
  242.    extensions as well as incrementing file names by specified values.
  243.  
  244. HTMSTRIP.EXE: Goes through downloaded pages from the Web  and  removes  embedded
  245.    HTML commands.  Reflows paragraphs and tries to make it  basically  readable.
  246.    Can function on individually-saved pages or else  process  your  entire  disk
  247.    cache. Awarded a "Best" rating by "PC Computing" in their  July  1996  issue.
  248.    Includes MOZ.EXE which renames the files in your Web  cache  subdirectory  so
  249.    you can identify them more easily.
  250.  
  251. PAGINATE.EXE: Reformats text files  with  embedded  formatting  codes.   Handles
  252.    things like titles, footers, indexes, alignment,  justification,  multicolumn
  253.    listings,  etc.   Also  provides  support  for  embedding  tabular  data   in
  254.    ASCII-delimited or dBase formats which can be embedded and/or sorted in  your
  255.    reports.
  256.  
  257. READ.EXE, READY.EXE, READINIT.EXE,  and  READMAKE.EXE:    Text   file   browsing
  258.    utilities.  READ--Supports marking, copying text, reading Unix and  Mac  text
  259.    files, etc.  Handles files of 16,000 lines or less  (approx  800,000  bytes).
  260.    READY--truncates or wraps lines over 255 characters  in  length  but  handles
  261.    files of an unlimited number of lines.  READMAKE--Takes  an  ASCII-text  file
  262.    and makes it self-viewable (using a READ clone).
  263.  
  264. TXTABLE.EXE: Program to generate text tables.  Allows inputs to be HTML-based as
  265.    well as one-record per cell.
  266.  
  267. 
  268.